Genel seçenekler¶

-C file, --config-file=file

~/.manpath varsayılanı yerine bu kullanıcı yapılandırma dosyasını kullanın.

-d, --debug

Hata ayıklama bilgisini göster.

-D, --default

Bu seçenek normalde ilk seçenek olarak verilir ve man's davranışını varsayılan değerine sıfırlar. Kullanımı, $MANOPT'da ayarlanmış olabilecek seçenekleri sıfırlamaktır. -D'yi takip eden tüm seçenekler normal etkiye sahiptir.

--warnings[=warnings]

groff 'dan uyarıları etkinleştirin. Bu, kılavuz sayfalarının kaynak metninde sağlama yapmak için kullanılabilir. warnings, virgülle ayrılmış uyarı adları listesidir; sağlanmazsa varsayılan "mac" olur. Kullanılabilir uyarı adlarının bir listesi için info groff'daki “Uyarılar” düğümüne bakın.

Ana işlem kipleri¶

-f, --whatis

whatis'e eşdeğerdir. Varsa, kılavuz sayfasından kısa bir açıklama görüntüle. Ayrıntılar için whatis(1)'e bakın.

-k, --apropos

% apropos% ile aynı. Anahtar kelimeler için kısa kılavuz sayfa açıklamalarını arayın ve tüm eşleşmeleri görüntüleyin. Ayrıntılar için apropos (1) bölümüne bakın.

-K, --global-apropos

Tüm kılavuz sayfalarında metin arayın. Bu kaba kuvvet araması ve muhtemelen biraz zaman alır; yapabiliyorsanız, aranması gereken sayfa sayısını azaltmak için bir bölüm belirtmelisiniz. Arama terimleri basit karakter katarları (varsayılan) veya --regex seçeneği kullanılıyorsa düzenli ifadeler olabilir.

Kılavuz sayfaların sources'ı arayacağını ve bunun kaynak dosyalardaki yorumları gibi şeyler nedeniyle yanlış pozitifleri içerebileceğini unutmayın. İşlenmiş metni aramak çok daha yavaş olacaktır.

-l, --local-file

Activate "local" mode. Format and display local manual files instead of searching through the system's manual collection. Each manual page argument will be interpreted as an nroff source file in the correct format. No cat file is produced. If '-' is listed as one of the arguments, input will be taken from stdin. When this option is not used, and man fails to find the page required, before displaying the error message, it attempts to act as if this option was supplied, using the name as a filename and looking for an exact match.

-w, --where, --path, --location

Don't actually display the manual page, but do print the location of the source nroff file that would be formatted. If the -a option is also used, then print the locations of all source files that match the search criteria.

-W, --where-cat, --location-cat

Don't actually display the manual page, but do print the location of the preformatted cat file that would be displayed. If the -a option is also used, then print the locations of all preformatted cat files that match the search criteria.

If -w and -W are both used, then print both source file and cat file separated by a space. If all of -w, -W, and -a are used, then do this for each possible match.

-c, --catman

Bu seçenek genel kullanım amaçlı değildir ve yalnızca catman programı tarafından kullanılmalıdır.

-R encoding, --recode=encoding

Elle sayfayı her zamanki gibi biçimlendirmek yerine, kaynaklarını belirtilen encoding'ya dönüştürülmüş olarak çıktıla. Kaynak dosyanın kodlamasını zaten biliyorsanız, doğrudan manconv(1) değerini kullanabilirsiniz. Bununla birlikte, bu seçenek, el ile bir sayfa hiyerarşisine benzer bir yapıya zaten kurulmuş olmaları koşuluyla, birkaç kılavuz sayfasını tek bir kodlamaya dönüştürmenizi sağlar; bu kodlamaların her ikisini de açıkça belirtmek zorunda kalmazsınız.

Consider using man-recode(1) instead for converting multiple manual pages, since it has an interface designed for bulk conversion and so can be much faster.

Kılavuz sayfalarında arama¶

-L locale, --locale=locale

man normalde mevcut yerel ayarınızı, muhtemelen $LC_MESSAGES ve $LANG öğelerini de içeren çeşitli ortam değişkenlerini sorgulayan C işlevi setlocale (3) çağrısı ile belirleyecektir. Belirlenen değeri geçici olarak geçersiz kılmak için doğrudan bir locale dizesini man 'a sunmak için bu seçeneği kullanın. Sayfalar için arama gerçekten başlayıncaya kadar etkili olmayacağını unutmayın. Yardım mesajı gibi çıktı her zaman başlangıçta belirlenen yerel ayraçta görüntülenir.

-m system[,...], --systems=system[,...]

Bu sistemin diğer işletim sisteminin kılavuz sayfalarına erişimi varsa, bu seçenek kullanılarak erişilebilir. NewOS'un kılavuz sayfa koleksiyonundaki bir kılavuz sayfasını aramak için -m NewOS seçeneğini kullanın.

Belirtilen system, virgülle sınırlandırılmış işletim sistemi adlarının birleşimi olabilir. Yerel işletim sisteminin kılavuz sayfalarını aramak için, argüman karakter katarına man sistem adını ekleyin. Bu seçenek, $SYSTEM çevre değişkeninin üzerine yazacaktır.

-M path, --manpath=path

Kullanmak için alternatif bir kılavuz yolu belirtin. Varsayılan olarak, man, arama yolunu belirlemek için manpath türetilmiş kodunu kullanır. Bu seçenek $MANPATH ortam değişkenini geçersiz kılar ve -m seçeneğinin yoksayılmasına neden olur.

Bir kılavuz yolu olarak belirtilen bir yol, man-db el kitabında ("Kılavuz sayfa sistemi" başlığı altında) açıklandığı gibi bölümlere yapılandırılmış bir kılavuz sayfa hiyerarşisinin kökü olmalıdır. Bu gibi hiyerarşiler dışında kılavuz sayfaları görüntülemek için -l seçeneğine bakın.

-S list, -s list, --sections=list

The given list is a colon- or comma-separated list of sections, used to determine which manual sections to search and in what order. This option overrides the $MANSECT environment variable. (The -s spelling is for compatibility with System V.)

-e sub-extension, --extension=sub-extension

Some systems incorporate large packages of manual pages, such as those that accompany the Tcl package, into the main manual page hierarchy. To get around the problem of having two manual pages with the same name such as exit(3), the Tcl pages were usually all assigned to section l. As this is unfortunate, it is now possible to put the pages in the correct section, and to assign a specific "extension" to them, in this case, exit(3tcl). Under normal operation, man will display exit(3) in preference to exit(3tcl). To negotiate this situation and to avoid having to know which section the page you require resides in, it is now possible to give man a sub-extension string indicating which package the page must belong to. Using the above example, supplying the option -e tcl to man will restrict the search to pages having an extension of *tcl.

-i, --ignore-case

Kılavuz sayfalarında ararken büyük/küçük harfi önemseme. Varsayılan budur.

-I, --match-case

Kılavuz sayfalarını büyük/küçük harf duyarlı ara.

--regex

apropos(1)'de olduğu gibi, tüm sayfaları isimlerinin ya da açıklamalarının herhangi bir parçası olan her page argümanına eşleşen düzenli ifadeler olarak gösterin. Normal bir ifade ararken "en iyi" sayfayı seçmek için genellikle makul bir yol bulunmadığından, bu seçenek -a anlamına gelir.

--wildcard

apropos(1) --wildcard ile olduğu gibi kabuk stili joker karakterleri kullanarak her sayfanın herhangi bir kısmıyla ya da açıklamaların her birinin page argümanıyla eşleşen tüm sayfaları gösterin. page bağımsız değişkeni tüm ad veya açıklama ile eşleşmeli veya açıklamadaki kelime sınırlarıyla eşleşmelidir. Bir joker karakter ararken bir "en iyi" sayfa seçmenin makul bir yolu genellikle bulunmadığından, bu seçenek -a anlamına gelir.

--names-only

--regex veya --wildcard seçeneği kullanılıyorsa, whatis(1)'de olduğu gibi sadece sayfa tanımlarıyla değil sayfa adlarıyla eşleşir. Aksi takdirde etki yaratmaz.

-a, --all

Varsayılan olarak, bulduğu en uygun kılavuz sayfası görüntüledikten sonra man çıkacaktır. Bu seçeneği kullanmak man ögesini, arama ölçütleriyle eşleşen tüm kılavuz sayfalarını görüntülemeye zorlar.

-u, --update

This option causes man to update its database caches of installed manual pages. This is only needed in rare situations, and it is normally better to run mandb(8) instead.

--no-subpages

Varsayılan olarak, man, komut satırında verilen kılavuz sayfa adlarının çiftlerini, kısa çizgi veya alt çizgi içeren tek bir kılavuz sayfası adına eşdeğer olarak yorumlamaya çalışacaktır. Bu, alt komutların kendilerini çağırmak için kullanılacak benzer sözdizimini kullanarak erişilebilen her birine kılavuz sayfalar sunmalarına izin veren bir takım alt komutları uygulayan ortak program modelini destekler. Örneğin:

  $ man -aw git diff
  /usr/share/man/man1/git-diff.1.gz

Bu davranışı devre dışı bırakmak için --no-subpages seçeneğini kullanın.

  $ man -aw --no-subpages git diff
  /usr/share/man/man1/git.1.gz
  /usr/share/man/man3/Git.3pm.gz
  /usr/share/man/man1/diff.1.gz

Biçimlendirilmiş çıktı denetleniyor¶

-P pager, --pager=pager

Specify which output pager to use. By default, man uses less, falling back to cat if less is not found or is not executable. This option overrides the $MANPAGER environment variable, which in turn overrides the $PAGER environment variable. It is not used in conjunction with -f or -k.

Değer, basit bir komut adı veya bağımsız değişkenler içeren bir komut olabilir ve kabuk alıntılama (ters eğik çizgi, tek tırnak veya çift tırnak işareti) kullanabilir. Birden fazla komutu bağlamak için boruları kullanamaz; buna ihtiyaç duyarsanız, dosyayı bir bağımsız değişken olarak veya standart girdi olarak görüntülemek üzere alabilecek bir sarıcı komut dosyası kullanın.

-r prompt, --prompt=prompt

Sayfalayıcı olarak lessin bir son sürümü kullanılıyorsa, man istemini ve mantıklı bazı seçeneklerini belirlemeye çalışacaktır. Varsayılan komut istemi şöyle

Manual page name(sec) line x

burada name klavuz sayfa adını belirtir, sec altındaki bölümü ve x geçerli satır numarasını gösterir. Bu, $LESS çevre değişkenini kullanarak gerçekleştirilir.

Supplying -r with a string will override this default. The string may contain the text $MAN_PN which will be expanded to the name of the current manual page and its section name surrounded by "(" and ")". The string used to produce the default could be expressed as

\ Manual\ page\ \$MAN_PN\ ?ltline\ %lt?L/%L.:
byte\ %bB?s/%s..?\ (END):?pB\ %pB\\%..
(yardım için h veya çıkmak için q)

Sadece okunabilirlik uğruna burada üç satıra ayrılmıştır. Anlamı için less(1) kılavuz sayfasını inceleyin. Komut karakter katarı önce kabuk tarafından değerlendirilir. Komut satırındaki tüm çift tırnak işaretleri, geri tırnak işaretleri ve ters eğik çizgiler bir önceki ters eğik çizgi ile öne çıkartılmalıdır. Komut istemi karakter katarı, less için daha fazla seçenek izleyebilen kaçışlı bir $ ile bitebilir. Varsayılan olarak man, -ix8 seçeneklerini ayarlar.

Aşağıda açıklanan $MANLESS ortam değişkeni, komut satırında hiçbiri sağlanmazsa, bir varsayılan istem karakter katarını ayarlamak için kullanılabilir.

-7, --ascii

7 bit terminal veya terminal emülatöründe saf bir ascii(7) kılavuz sayfasını görüntülerken, GNU nroff ile latin1(7) cihaz açıklaması kullanılırken bazı karakterler doğru görüntülenmeyebilir. Bu seçenek saf ascii kılavuz sayfalarının ascii'de latin1 aygıtıyla görüntülenmesine izin verir. Herhangi bir latin1 metnini tercüme etmez. Aşağıdaki tabloda yapılan çeviriler gösterilmektedir: GNU nroff'un latin1(7) aygıtı kullanılırken bazı kısımları düzgün bir şekilde görüntülenebilir.

Açıklama	Sekizli	latin1	ascii
devam tire	255	‐	-
madde imi (orta nokta)	267	•	o
tiz vurgu	264	´	'
çarpma işareti	327	×	x

latin1 sütun doğru görüntülenirse, terminaliniz latin1 karakterleri için ayarlanmış olabilir ve bu seçenek gerekli değildir. latin1 ve ascii sütunları aynı ise, bu seçeneği kullanarak bu sayfayı okuyorsunuz veya man bu sayfayı latin1 aygıt açıklamasıyla biçimlendirmedi. latin1 sütun eksik veya bozuksa, bu seçenekle kılavuz sayfaları görüntülemeniz gerekebilir.

Bu seçenek, -t, -H, -T veya -Z seçeneklerini kullanırken göz ardı edilir ve nroff için GNU's dışında işe yaramayabilir.

-E encoding, --encoding=encoding

Varsayılandan farklı bir karakter kodlaması çıktısı oluşturun. Geriye dönük uyumluluk için, encoding, ASCII, latin1 veya utf8 gibi nroff aygıtlarının yanı sıra UTF-8 gibi gerçek bir karakter kodlaması olabilir.

--no-hyphenation, --nh

Normalde, nroff satır aralarında, kısa çizgiler içermeyen kelimelerde bile metinleri otomatik olarak tirelendirir; bunu, aşırı boşluk bırakmadan bir satıra kelimeler yerleştirmek için yapmak gerekliyse yapar. Bu seçenek otomatik tirelemeyi devre dışı bırakır, bu nedenle sözcükler yalnızca tireler içeriyorsa tireleme yapılır.

Kılavuz sayfası yazıyorsanız ve nroff'un uygun olmayan bir noktadaki tirelemesini engellemek istiyorsanız, bu seçeneği kullanmayın, bunun yerine nroff belgelerine bakın; örneğin, o noktada tireleyebileceğini belirtmek için bir kelimenin içine "\%" koyabilir veya tirelenmemesi için bir kelimenin başlangıcına "\%" koyabilirsiniz.

--no-justification, --nj

Normalde nroff metni her iki kenar boşluğa otomatik olarak yaslı gösterecektir. Bu seçenek tam ayraçlamayı devre dışı bırakır ve yalnızca "soluk-sağ" metin olarak adlandırılan sol kenar boşluğuna dayandırarak bırakır.

Kılavuz sayfası yazıyorsanız ve sadece nroff'un belirli paragraflarının haklı çıkmasını önlemek istiyorsanız, bu seçeneği kullanmayın, bunun yerine nroff belgelerine bakın; örneğin, ".na", ".nf", ".fi" ve ".ad" isteklerini geçici olarak ayarlamayı ve doldurmayı devre dışı bırakmak için kullanabilirsiniz.

-p string, --preprocessor=string

nroff veya troff/groff'den önce çalıştırılacak önişlemcilerin sırasını belirtin. Tüm kurulumlar tam önişlemci setine sahip olmaz. Önişlemcilerden bazıları ve bunları belirlemek için kullanılan harfler şunlardır: eqn (e), grap (g), pic (p), tbl (t), vgrind (v), refer (r). Bu seçenek, $MANROFFSEQ ortam değişkeninin üzerine yazılır. zsoelim her zaman ilk önişlemci olarak çalıştırılır.

-t, --troff

Kılavuz sayfasını stdout için biçimlendirirken groff -mandoc kullanın. Bu seçenek, -H, -T veya -Z ile birlikte gerekli değildir.

-T[device], --troff-device[=device]

Bu seçenek, groff (veya muhtemelen troff's) çıktısını, varsayılan dışında bir cihaz için uygun olacak şekilde değiştirmek için kullanılır. Bu, -t ima eder. Örnekler (Groff-1.17 ile sağlanır) dvi, latin1, ps, utf8, X75 ve X100'i içerir.

-H[browser], --html[=browser]

Bu seçenek groff'un HTML çıktısı üretmesine neden olur ve bu çıktıyı bir web tarayıcısında görüntüler. Tarayıcı seçimi, isteğe bağlı bir browser argümanı varsa, $BROWSER ortam değişkeni tarafından belirlenir veya ayarlanmamışsa derleme zamanı varsayılanı (genellikle lynx) ile belirlenir. Bu seçenek -t ima eder ve yalnızca GNU troff ile çalışır.

-X[dpi], --gxditview[=dpi]

Bu seçenek groff programının çıktısını grafiksel bir pencerede gxditview programıyla gösterir. dpi (inç başına nokta) 75, 75-12, 100 veya 100-12 olabilir, varsayılan olarak 75 olur; -12 varyantları 12 punto baz font kullanır. Bu seçenek, sırasıyla X75, X75-12, X100 veya X100-12 cihazında -T anlamına gelmektedir.

-Z, --ditroff

groff, troff komutunu çalıştırıp seçilen aygıt için uygun çıktı üretmek için uygun bir post-işlemci kullanacaktır. Eğer groff -mandoc, groff ise, bu seçenek groff'e geçirilir ve bir post-işlemcinin kullanımını bastırır. Bu, -t ima eder.

Yardım alma¶

-?, --help

Bir yardım iletisi göster ve çık.

--usage

Kısa kullanım iletisini göster ve çık.

-V, --version

Sürüm bilgisini göster.